Canigó - Detall dels tags - checkbox

Detall dels tags - checkbox

Defineix un botó de finalització d'un formulari.

Estén el tag layout:checkbox ( http://struts.application-servers.com/doc/tags/field.html#checkbox ) de Struts-Layout.

La documentació auto-generada del tag és a http://canigo.ctti.gencat.net/confluence/canigodocs/site/canigo2_2/tlddoc/fwk/checkbox.html

Atributs heredats

Els atributs heredats de layout:checkbox son: accesskey, arg0, arg1, arg2, arg3, arg4, bundle, hint, key, layoutId, maxlength, mode, name, onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, policy, property, styleClass, tooltip, value.

Atributs específics de Canigó

Atribut Funció
layout (true / false) Especifica si s'ha de generar o no etiqueta associada
services  
styleId Identificador del tag, per lligar-lo amb la configuració injectada amb Spring
tooltipKey Clau del literal del missatge a mostrar dins el tooltip.
tooltipOptions  
tooltipTitleKey Clau del literal a mostrar si volem mostrar un títol com a capçalera del tooltip

Per utilitzar els Tooltips cal incloure un conjunt d'arxius JavaScript i CSS:

  • el full d'estil tooltips.css
  • els arxius de scripts domLib.js i domTT.js
<LINK REL=StyleSheet
      HREF="css/tooltips/tooltips.css"
      TYPE="text/css"
      MEDIA=screen>

<script type="text/javascript"
        src="<c:url value="/scripts/tooltips/dom_tooltip/domLib.js"/>">
</script>
<script type="text/javascript"
        src="<c:url value="/scripts/tooltips/dom_tooltip/domTT.js"/>">
</script>

Exemple

A continuació es presenta un fragment de pàgina que utilitza el tag fwk:checkbox

Pàgina JSP

<script type="text/javascript"
        src="<c:url value="/scripts/tooltips/dom_tooltip/domLib.js"/>">
</script>
<script type="text/javascript"
        src="<c:url value="/scripts/tooltips/dom_tooltip/domTT.js"/>">
</script>

<LINK REL=StyleSheet
      HREF="css/tooltips/tooltips.css"
      TYPE="text/css"
      MEDIA=screen>

<fwk:form action="provesTagsSimple.do"
          styleId="myActionForm"
          reqCode="show"
          method="post"
          layout="true">
    (...)
    <fwk:checkbox styleId="camp3"
                  key="jsp.provesTags.ProvesTagsSimple.camp3"
                  mode="E,E,E"
                  layout="true"
                  tooltipTitleKey="jsp.provesTags.ProvesTagsSimple.camp3.tipTitle"
                  tooltipKey="jsp.provesTags.ProvesTagsSimple.camp3.tip"
                  property="camp3"/>
    (...)
</fwk:form>

Arxius d'internacionalització

jsp.provesTags.ProvesTagsSimple.camp3=Tercer camp
jsp.provesTags.ProvesTagsSimple.camp3.tipTitle=Ajuda
jsp.provesTags.ProvesTagsSimple.camp3.tip=Ajuda del tercer camp, que és un Checkbox

Bugs

  • L'utilització dels atributs tooltipKey i tooltipTitleKey no inclouen automàticament els arxius javascript necessàris i cal fer-ho explícitament.